home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / rem_acc / ramsv111.zip / RAMS.DOC < prev    next >
Text File  |  1996-02-20  |  91KB  |  2,328 lines
  1. **********************************************
  2.   * RemoteAccess Automated Message System v1.11 *
  3.     *           CopyRight 1995-96 by               *
  4.        *                INXS Software                *
  5.          *         (Eddy Matthews & Geoff Bassett)     *
  6.             **********************************************
  7.  
  8.  
  9.  
  10.     Announcing an ALL NEW automated message system for RemoteAccess BBS.
  11.  
  12.     This is the second official release of RAMS.. Please see the WhatsNew
  13.     file included in the archive for a list of new features/bug fixes.
  14.  
  15.     RemoteAccess Automated Message System  (RAMS)  is  a fully  automated
  16.     message posting utility that takes care of all the boring messages  a
  17.     busy Sysop needs to send to his users. It supports RA v2.0x. A version
  18.     that supports RA v2.5x will be released at a later date.  It has full
  19.     support for both Hudson and JAM message bases, as well as Local and/or
  20.     Echo messages
  21.  
  22.     RAMS will automatically  send  Welcome  messages to new users,  thank
  23.     uploaders, warn those that drop carrier, send birthday messages, send
  24.     a message after X calls, send a message based on a keyword  or string
  25.     that YOU define, send regular messages such as BBS ads, send messages
  26.     on a certain date, and numerous others... Apart from sending messages
  27.     to the users,RAMS will also send reports of it's actions to the Sysop
  28.     and generate a detailed logfile that shows  any actions it has taken.
  29.     YOU decide what messages it sends...  If you don't want to warn users
  30.     that drop carrier, simply turn off that message...
  31.  
  32.     Carrier drop messages will  NOT  be sent to a user if they were in an
  33.     external program.So you can safely use RAMS even if you have a system
  34.     stuffed full of type 7 and type 15 doors.
  35.  
  36.     RAMS can upgrade users, or downgrade them based on what they do.  YOU
  37.     decide what it does, or indeed whether it does anything! You  can also
  38.     EXCLUDE certain users from getting messages if you want.
  39.  
  40.     The template files it uses for it's  messages  are  plain ascii  text
  41.     files that YOU can configure to suit YOUR system. It also has over 80
  42.     metastrings  that  you  can  use to  make the messages as flexible as
  43.     possible (example messages are included in the archive).
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                ---- 2 ----
  59.  
  60.  
  61.                              LEGAL DISCLAIMER
  62.                              ================
  63.  
  64.     This program is NOT free,  it is shareware.  Any use of this program
  65.     after an initial  30 day trial period requires you  to register your
  66.     copy with the author.   Details on how to register are given  at the
  67.     end of this document.  Unregistered distribution copies of  RAMS are
  68.     released  with an inbuilt 30  day run time after  which delays  will
  69.     occur when the program is run.......
  70.  
  71.     Please remember shareware programs  can  only continue to develop if
  72.     they have YOUR support,  failure to  register will ONLY  end in this
  73.     and other  shareware programs  being  abandoned  which in  turn will
  74.     mean you have a reduced choice of cheap well written programs.
  75.  
  76.     This program and it's  accompanying  documentation are guaranteed to
  77.     do nothing other than take up space on your drive.
  78.  
  79.     The authors and their agents  will not  accept any liability for any
  80.     consequential loss or  damage arising from  your use or inability to
  81.     use  RAMS  or any of  the information  provided,  including, but not
  82.     limited  to,  economic  or  financial loss,   damage  to  peripheral
  83.     equipment or products, loss of use, productivity or time.
  84.  
  85.     Whilst  every  effort has been  made to  ensure  its reliability and
  86.     functionality you use this  program entirely at your own risk and no
  87.     warranties of  any type are given, either expressed or implied.
  88.  
  89.     The program  and the associated documentation on disk may be  freely
  90.     distributed on the following conditions:=
  91.  
  92.           1)  No changes whatsoever are made to the program,
  93.               its documentation or any associated files.
  94.  
  95.           2)  Anyone  wishing to charge a fee for distributing
  96.               RAMS  must  have  the  written  consent  of  the
  97.               author.  No charge will be made for this consent
  98.               but  I need  to  know  who is distributing it so
  99.               that I can send out updates  -  Apply in writing
  100.               to the address at the end of this document.
  101.  
  102.  
  103.     NOTE - For the benefit of printing this document out the pages have
  104.            been formatted to 56 lines per page.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                                 ---- 3 ----
  115.  
  116.    CONTENTS
  117.    --------                                                     page
  118.  
  119.    About RAMS   . . . . . . . . . . . . . . . . . . . . . . . . .  1
  120.  
  121.    Legal Disclaimer . . . . . . . . . . . . . . . . . . . . . . .  2
  122.  
  123.    Program description  . . . . . . . . . . . . . . . . . . . . .  4
  124.  
  125.    Whats in the archive . . . . . . . . . . . . . . . . . . . . .  6
  126.  
  127.    Message Types  . . . . . . . . . . . . . . . . . . . . . . . .  7
  128.  
  129.    Upgrading from previous versions . . . . . . . . . . . . . . .  13
  130.  
  131.    Installation   . . . . . . . . . . . . . . . . . . . . . . . .  13
  132.  
  133.    Getting Started  . . . . . . . . . . . . . . . . . . . . . . .  14
  134.  
  135.    The menu options . . . . . . . . . . . . . . . . . . . . . . .  15
  136.  
  137.    System setup . . . . . . . . . . . . . . . . . . . . . . . . .  17
  138.  
  139.    Message menu options . . . . . . . . . . . . . . . . . . . . .  18
  140.  
  141.    Echomail information . . . . . . . . . . . . . . . . . . . . .  23
  142.  
  143.    Conditions & actions . . . . . . . . . . . . . . . . . . . . .  23
  144.  
  145.    The Message Template Editor  . . . . . . . . . . . . . . . . .  27
  146.  
  147.    Excluding users  . . . . . . . . . . . . . . . . . . . . . . .  28
  148.  
  149.    Installing RAMS into your BBS batchfile  . . . . . . . . . . .  29
  150.  
  151.    Multiline Systems  . . . . . . . . . . . . . . . . . . . . . .  31
  152.  
  153.    Metastrings used by RAMS . . . . . . . . . . . . . . . . . . .  33
  154.  
  155.    How to get the most out of RAMS  . . . . . . . . . . . . . . .  37
  156.  
  157.    Contacting the authors . . . . . . . . . . . . . . . . . . . .  40
  158.  
  159.    Future developement  . . . . . . . . . . . . . . . . . . . . .  41
  160.  
  161.    Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                                 ---- 4 ----
  171.  
  172.                                WHAT IS RAMS?
  173.                                =============
  174.  
  175.     RemoteAccess Automated Message System, hereafter referred to as RAMS,
  176.     has been developed to be the number one automatic message system for
  177.     Sysops of RemoteAccess bulletin board systems.
  178.  
  179.     It will work with both Hudson and the JAM messagebase formats, and is
  180.     capable of posting both local and echomail messages.
  181.  
  182.     RAMS  will  fully automate all of those tedious messages that Sysops
  183.     need to post to users. It needs only a minimal setup to get it going
  184.     and can be up and running in a matter of minutes,  though to get the
  185.     best out of RAMS it is recommended that  you  take time to study all
  186.     of its many features in some detail.
  187.  
  188.     Much time and effort was put into the configuration utility for RAMS
  189.     in order to make the  program as easy to setup and  as user friendly
  190.     as possible. The setup utility has an extensive online help facility
  191.     to help  you through  the setup  stages  while you  are learning the
  192.     program.
  193.  
  194.     In addition RAMS will generate daily and weekly reports to the sysop
  195.     to inform them how many of which  type of messages  RAMS  has posted
  196.     for each day,along with a brief report on available hard drive space.
  197.     RAMS will generate a message to  the  sysop  for  every user message
  198.     that it sends, of course this feature can be disabled if you wish!
  199.  
  200.     RAMS can automatically send the following messages to your users:=
  201.  
  202.     -     Welcome to new users
  203.  
  204.     -     Thankyou for uploading
  205.  
  206.     -     Carrier Drop - send message to  users that drop carrier.  RAMS
  207.           will work correctly with MOST doors - type 7 and 15.
  208.           If it cannot decide if the user has dropped carrier,   because
  209.           they were in an  external program  it will  NOT post a carrier
  210.           drop msg.
  211.  
  212.     -     Watchdog Messages - post a message to a user if he/she exceeds
  213.           the number of  times he/she is allowed to attempt to enter the
  214.           correct password.  This message also lists  any passwords that
  215.           were tried!
  216.  
  217.     -     Send a message to users after  every so  many calls  he or she
  218.           has made to your system.  i.e.  send  a message after 10 calls
  219.           made by a user (Times On)
  220.  
  221.     -     KeyWord messages - This is a VERY powerful message type  which
  222.           will tell RAMS to search RA's log file for a keyword or phrase
  223.           you have defined and send the appropriate message.
  224.           (fully configurable)
  225.  
  226.                                 ---- 5 ----
  227.  
  228.  cont...
  229.  
  230.     -     Every N'th call made by user  - Send a msg. after EVERY Nth call
  231.           .. i.e.,  set it to 10 and Rams will post a msg. to the user after
  232.           EVERY 10 calls... 10,20,30 calls etc.. etc..
  233.           (fully configurable)
  234.  
  235.     -     Happy Birthday (automatically generated on users birthday)
  236.  
  237.     -     Subscription expiry - with this type of message it is possible
  238.           to send messages warning users  of their imminent subscription
  239.           expiry,  and also  to  optionally downgrade their  access once
  240.           their subscription has expired.
  241.           (configurable for # of days before expiry to send message)
  242.  
  243.  
  244.     In addition  to  those above,  RAMS  can  also  send messages to the
  245.     Sysop:=
  246.  
  247.     -     Daily Report - details  of RAMS's  daily  activities  with  an
  248.           optional report on hard drive space.
  249.  
  250.     -     Weekly report - as above, but weekly stats
  251.  
  252.     RAMS  will  also send  and  Echomail/local messages on behalf of the
  253.     Sysop:-
  254.  
  255.     -     The Regular Post type of message allows you to fully  automate
  256.           those regular  echomail  messages  such  as BBS advertisements,
  257.           echo rules etc. This type of message is sent every X days.
  258.  
  259.     -     Monthly post - as with the Regular post, but on a specific day
  260.           each month.
  261.  
  262.     -     Yearly post - Send  Xmas  and New Year greetings automatically
  263.           to your users or other systems.   YOU decide what date to send
  264.           the message, and what is contained in the message text.
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.                                 ---- 6 ----
  283.  
  284.                               IMPORTANT NOTE!
  285.                               ===============
  286.     When  RAMS  posts  these  messages it is  also  capable  of  changing
  287.     a users settings, ie Seclevel, Flags, Group etc.  and it  can also be
  288.     setup  so  that messages  will  ONLY  be sent if a user meets certain
  289.     criteria defined by you i.e. Security level - Min and Maximum.
  290.     When posting a message to a user, RAMS will use the users REAL name.
  291.  
  292.     These features are all described in detail later in this document.
  293.     NOTE.
  294.  
  295.  
  296.                                    FILES
  297.                                    =====
  298.     You Should find the following files inside the distribution archive:
  299.  
  300.  
  301.          UPDATE.EXE    - Program to update previous releases of Rams
  302.          RAMS.EXE      - The main executable file
  303.          RAMSCFG.EXE   - The setup program used to configure RAMS
  304.          RAMS.DOC      - Documentation for RAMS (what your reading now!)
  305.          REGISTER.NFO  - Registration document for all countries.
  306.          MOMUPGRD.REG  - Registration form if UPGRADING from MOM ONLY!.
  307.          SAMPLE.ZIP    - Sample Message files for use with RAMS
  308.                          (see the section on meta strings for more info)
  309.                          It is recommended that you unpack  this  archive
  310.                          into a  separate directory   off  the  main Rams
  311.                          directory so as not to  clutter it  up  with all
  312.                          the msg. template files.
  313.          EXCLUDE.CTL   - An example EXCLUDE control file for Rams. Please
  314.                          see the file for a more detailed explanation of
  315.                          it's use. It's heavily commented. Rams will run
  316.                          without this file, but it WILL generate an error
  317.                          message. This will NOT affect the running of Rams.
  318.          WHATSNEW.TXT  - A list of the new features/bug fixes since the
  319.                          last release of Rams. If you are already using
  320.                          Rams you should read this file.
  321.  
  322.          NOTE..
  323.          Rams  (and it's associated configuration program)  will generate
  324.          the following files when it is run.
  325.  
  326.          RAMS.DAT - Used to store message counters,  last caller info and
  327.                     other data used by Rams.
  328.          RAMS.CFG - The  main config file  used  by Rams  to tell it what
  329.                     messages are active, path to logfiles,  message bases
  330.                     to use
  331.  
  332.      !! YOU MUST USE RAMSCFG.EXE TO EDIT THIS FILE TO SUIT YOUR SYSTEM !!
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                                 ---- 7 ----
  339.  
  340.     MESSAGE TYPES - a basic outline.
  341.     -------------------------------
  342.  
  343.     This is just a quick outline of the message types available to you,
  344.     more detailed descriptions of  what is required for each message type
  345.     can be got  by  referring to  the section of the docs dealing with the
  346.     various  'fields'  for  each  message.   There  you  will  find  more
  347.     information on what is required for each 'field' in RamsCfg.
  348.  
  349.     Rams currently  has a  total of 14 message types which it can post to
  350.     users  depending on  what  actions they  have  taken while  they were
  351.     online.
  352.     YOU  decide  which messages are  sent by toggling the Active/Disabled
  353.     switch for each msg. in the RamsCfg program.  If The message is set as
  354.     Disabled, it will NOT be sent to any users.
  355.  
  356.     If you run RamsCfg you will see that  the messages are split into two
  357.     basic types,  'Normal' and 'Midnight'. 'Normal' messages will be sent
  358.     as soon as the user has logged off your system,   'Midnight' messages
  359.     (as the name suggests) will  ONLY  be posted on the first run of Rams
  360.     after midnight. Rams will automatically detect the date rollover and
  361.     send any 'Midnight' messages that are necessary  the first time it is
  362.     executed after midnight.  You DO NOT need to have a separate midnight
  363.     event for Rams.
  364.  
  365.     Rams has both 'User' and 'Sysop' messages. As the names suggest,'User'
  366.     MSG's are sent to the user, and 'Sysop' messages are sent to the Sysop.
  367.     'User' msgs are posted  (if enabled)  to the  user if they do certain
  368.     things that are assigned  to the message,   i.e.. Any new users will be
  369.     sent a 'Welcome' message to welcome them to your system.   The 'Sysop'
  370.     messages are basically designed to be reports that  Rams will send to
  371.     you telling you what it has done.  There is no need to enable  'Sysop'
  372.     messages if you don't want them, as Rams keeps a full history of it's
  373.     actions in it's logfile.
  374.  
  375.     There are also nearly ONE HUNDRED metastrings that you can use in the
  376.     messages.
  377.     They are basically used  to  personalise any messages that are posted
  378.     by Rams,  and  will  allow  you to  include  user data in the message.
  379.     Things such as the user name,  date of birth,  age, the date and time
  380.     the msg. was sent etc. etc..  They  are  described in  MUCH more detail
  381.     elsewhere in the docs,and an idea of how they are used can be gleaned
  382.     by referring to the example message templates supplied in  the release
  383.     archive.
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                 ---- 8 ----
  393.  
  394.     NORMAL MESSAGES
  395.     ---------------
  396.     These messages are sent as soon as the user logs off your system.
  397.  
  398.  
  399.     WELCOME
  400.     --------
  401.     This message  (If activated)  will be sent to any  NEW users to  your
  402.     system.  It is designed to  'Welcome' new users to your BBS.  It will
  403.     only be posted ONCE to any NEW users.This message is your opportunity
  404.     to say 'Hi' and let users know about your setup etc.
  405.  
  406.  
  407.     UPLOAD
  408.     ------
  409.     This is posted to anyone that 'Uploads' any files to your system.  It
  410.     will send a 'Thankyou' message to them. It will NOT send a message if
  411.     the upload was a 'File attach'  but ONLY if it was a normal upload to
  412.     one of your file areas.  A quick 'Thankyou' message can do wonders at
  413.     getting users to upload! :-)
  414.     Please note,  that  this  feature may  not work  if you  are using an
  415.     external file manager, but it has been tested with Derek Bryant's FLM
  416.     program and works perfectly with  that providing that FLM writes it's
  417.     log to RA's logfile.
  418.  
  419.  
  420.     WATCHDOG
  421.     --------
  422.     This message will be sent if the user EXCEEDS the number of passwords
  423.     allowed on your system. It can be setup to include the passwords that
  424.     were tried and is  designed to  warn  users of  possible  attempts by
  425.     someone else to gain access to their account.   If you  decide to use
  426.     this option, please ensure you disable RA's internal watchdog message
  427.     or you will get duplicates!
  428.  
  429.  
  430.     CARRIER DROP
  431.     ------------
  432.     Basically this message will be sent if the user Drops Carrier without
  433.     logging off your system correctly.
  434.  
  435.     This is the first of the 'Multi' style messages.  By 'Multi', we mean
  436.     you can setup MULTIPLE  messages  and therefore have  the ability  to
  437.     send a different msg. to your users based on their security level and/
  438.     or age. Bear in mind that Rams will post  EVERY message that the user
  439.     meets the 'Conditions' for, so be careful when setting up the message
  440.     conditions if you  are using more than  one  Carrier  Drop msg.   The
  441.     'Conditions' are described in more detail elsewhere in these docs.
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.                                 ---- 9 ----
  449.    cont...
  450.  
  451.     Rams will ONLY normally  send a  carrier drop message if the user was
  452.     in RA when they dropped carrier.   If  they were  in an external door
  453.     program (either type 7 OR type 15) it will  simply report that it was
  454.     'Unable to determine' what happened,   and NO message will be sent...
  455.     Therefore you can SAFELY use RAMS  even  on a  system that is stuffed
  456.     full of online doors (games, mail doors, time banks etc.).
  457.  
  458.     There is  also the  facility to specify a 'List' of doors that DO NOT
  459.     allow a user to logoff.   If a  door program DOES NOT allow a user to
  460.     logoff from within it,  you  can enter and part of the 'DOS shell' or
  461.     'Exit at errorlevel' string that is  written to  RA's  log  into this
  462.     'List' and Rams WILL  then  send  a carrier  drop message even if the
  463.     user was in that particular door. Please note, this is ONLY for doors
  464.     that DO NOT allow a user to legitimately logoff from within them!
  465.     Using  it  for  a door  that  users  can  logoff  from (Blue Wave for
  466.     example)  WILL cause  problems as  Rams WILL then send a carrier drop
  467.     message even if the user has logged off correctly.
  468.  
  469.  
  470.     TIMES ON
  471.     --------
  472.     This message is sent after the user has called your system 'X' times.
  473.     i.e.. if you set it for 10 it will send the user a message after he/she
  474.     has made a TOTAL of 10 calls to your system,   if  you set it for 250
  475.     it will send a message after the user has made a TOTAL of 250 calls.
  476.  
  477.     Again, this is a 'Multi' style message,  so  you  can  setup up to 10
  478.     different 'Times On' messages all with different values if you wish.
  479.     'Multi' messages are described  in more detail in  the 'Carrier Drop'
  480.     message description and elsewhere in this doc file.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.     KEYWORD
  488.     -------
  489.     This is perhaps one  of the most  flexible message types available in
  490.     Rams.   With it,  YOU can specify a string from your RA logfile,  and
  491.     Rams will post a message IF it  finds that  particular string in RA's
  492.     log after the user has logged off your system.
  493.     Because  this message  can  be  used  for almost  any  purpose  it is
  494.     impossible for  us  to supply a  generic message template file for it.
  495.     But to give you some  idea of how it could be used, you could enter a
  496.     string of 'BLUEWAVE.BAT' (without the quotes!) and, assuming the Blue
  497.     Wave mail door was called up  from  a batchfile  called  BLUEWAVE.BAT
  498.     Rams would send the user a message if he/she entered that door... You
  499.     could then write a message template file  saying  'Why  not  become a
  500.     point off ???? BBS?'. That's only a suggestion to give you an idea of
  501.     just how flexible this message can be....   YOU decide what string to
  502.     search for AND what message to send if it's found.   Please note that
  503.  
  504.  
  505.  
  506.                                ---- 10 ----
  507.  
  508.    cont...
  509.  
  510.     Rams will ONLY generate  a message  based on the FIRST  match to  the
  511.     string you specify..If the string isn't found NO message will be sent.
  512.  
  513.  
  514.     Nth CALL
  515.     --------
  516.     This message is similar to the  'Times On' message,  except  that the
  517.     value you specify will cause a message to be sent by Rams after EVERY
  518.     'X' calls.  So if you set it up to use a value of 6,  Rams would send
  519.     the user a message after he/she had called your system 6 times,  then
  520.     again after 12 calls, again after 18 calls etc. etc...
  521.  
  522.  
  523.  
  524.     MIDNIGHT MESSAGES
  525.     -----------------
  526.     All 'Midnight'  messages are sent ONCE per day on the first run after
  527.     midnight.   Although Rams will do this without your having to setup a
  528.     separate midnight event,  it is still recommended that you set one up
  529.     to ensure that Rams does it's  daily procedures.  If  you  had  a day
  530.     without any calls to your system (unlikely), Rams may miss some daily
  531.     messages it needs to send.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.     DAILY REPORT
  543.     ------------
  544.     This is a message to the Sysop ONLY.  It  will give  a  report of the
  545.     previous days activity by Rams,  listing the quantity of each type of
  546.     message it has sent.   The message is basically there so you can keep
  547.     an eye on Rams's activity It can also give a listing of free and used
  548.     drivespace on your system. Useful in case your away from your machine
  549.     for a while. See the example DAYREPT.MSG message template.
  550.  
  551.  
  552.     WEEKLY REPORT
  553.     -------------
  554.     As with the Daily Report,  this message is to the Sysop ONLY. It will
  555.     give a list of all messages posted in the previous week by Rams.   It
  556.     can also give a listing of  drivespace  used and free  on your system
  557.     if you wish. See the example WEEKRPT.MSG  message  template  for more
  558.     info.
  559.  
  560.  
  561.  
  562.                                 ---- 11 ----
  563.  
  564.     HAPPY BIRTHDAY
  565.     --------------
  566.     Here Rams will send every  user  a  birthday  message if  it is their
  567.     birthday on that particular day.  A nice touch that helps keep you in
  568.     high esteem with your callers.   Rams  will post  ONE message to each
  569.     user on their birthday,  so it may  send quite a few on a busy system.
  570.     However it  will  only send  ONE  Sysop report  message  if  they are
  571.     enabled,  which can list ALL the users it has sent birthday  messages
  572.     to that day.   See the USERBDAY.MSG and SYSBDAY.MSG message templates
  573.     for an idea of what you can do with these messages.
  574.  
  575.  
  576.     REGULAR POST
  577.     ------------
  578.     Another of the 'Multi' style  messages available  in  Rams -  See the
  579.     Carrier Drop message for more info on 'Multi' messages.
  580.  
  581.     Here you can setup a message that will be posted EVERY 'X' days... If
  582.     you set it to a value of 10 for example,  it  will  post that message
  583.     EVERY 10 days. You have a maximum of 10 Regular Post messages you can
  584.     setup for various things.   This  would be ideal for those boring old
  585.     'BBS Advert' style messages,or for announcing the 'Rules' for an echo
  586.     area etc. etc.
  587.  
  588.     This message also allows you to specify a 'Post to' name...  here you
  589.     can enter 'All' or  a 'User Name'  (Without the quotes!),  or you can
  590.     even use the '@ALL' macro  (as in RA)  and  Rams  will  then  post an
  591.     individual message to EVERY user  that satisfies the  'Conditions' of
  592.     the message. Please note, setting this msg. to  use the  '@ALL'  macro
  593.     (Without the quotes!) can produce a LOT of messages  if  most of your
  594.     users meet the conditions assigned to it, it may also take some  time
  595.     to complete!
  596.  
  597.  
  598.     MONTHLY POST
  599.     ------------
  600.     Exactly the same as the 'Regular Post' message, except that Rams will
  601.     post the message on the date of the month you have specified.  If you
  602.     give it a value of 15 for example, Rams will post that message on the
  603.     15th of EVERY month, i.e. 15th January, 15th February,  15th  March etc.
  604.     etc...
  605.  
  606.     As with the 'Regular Post' messages you can also use the '@ALL' macro
  607.     in this message type. See Regular Post messages for more info.
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.                                 ---- 12 ----
  619.  
  620.     YEARLY POST
  621.     -----------
  622.     Exactly the same as the 'Regular Post' messages,   except  that  this
  623.     time you have to specify a date and month as values for the message.
  624.     For example,  if you set  it to 15  for the day,  and 7 for the month,
  625.     Rams would post the message on the 15th of July EVERY year... As with
  626.     all the other 'Multi' style messages you can  setup  a  total  of ten
  627.     Yearly Post messages each  with a different date,  or  with  the same
  628.     date but different 'Conditions'. So you can easily setup a message to
  629.     be posted on 25th December  to  wish all your users 'Happy Christmas'
  630.     etc. etc.
  631.  
  632.     As with the  'Regular Post' messages,  you  can also  use the  '@ALL'
  633.     macro in this message type. See Regular Post messages for more info.
  634.  
  635.  
  636.     SUBSCRIPTION
  637.     ------------
  638.     This message type allows  you to warn  your  subscribers  when  their
  639.     subscription is due.   You can specify  a number of days BEFORE their
  640.     subs expire for Rams to send them a message.    So if you entered 30,
  641.     Rams would send them a message 30 days BEFORE their subscription  was
  642.     due...   Again  you have  a total of  10  messages  so you  can setup
  643.     different messages for different security levels, or post one message
  644.     30 days before their subs expire and another 7 days before etc. etc..
  645.  
  646.     As with  ALL  midnight messages,     Rams  will  post  any  necessary
  647.     subscription msgs automatically in it's daily procedures...
  648.  
  649.     Don't forget,  if your system  should be down for a few days,  or  it
  650.     misses a midnight event and Rams is not run EVERY day,  Rams will NOT
  651.     post any messages it may have missed.  It is up to YOU to ensure that
  652.     Rams is run  AT LEAST  once per day  so it  can  post  any  necessary
  653.     midnight messages.
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                                 ---- 13 ----
  675.  
  676.                       UPGRADING FROM PREVIOUS VERSIONS
  677.                       ================================
  678.     If you are using Rams v1.10 (NOTE v1.10, NOT v1.01!) you DO NOT need
  679.     to do anything other than overwriting the EXE files with the versions
  680.     in this archive. This version (v1.11) is only a very minor bugfix and
  681.     needs no upgrading if you are already using v1.10...  However if you
  682.     are using an earlier version, please follow the instructions below.
  683.  
  684.     If you are already using Rams v1.00, v1.01, or v1.02 you DO NOT need
  685.     to redo all the setup.   Simply copy  the RAMS.EXE, RAMSCFG.EXE  and
  686.     UPDATE.EXE into your Rams directory (overwriting the existing files)
  687.     Then change to your Rams directory and run UPDATE.EXE.
  688.  
  689.     This will update your existing configuration, and DELETE the RAMS.DAT
  690.     file. Rams will recreate the Dat file the first time it is run, but
  691.     you should note that this will cause all message counters (used in-
  692.     the daily and weekly reports) to be zeroed.
  693.  
  694.     You should take a look through the config program after doing this as
  695.     a LOT of new features - mainly to do with 'Conditions/Actions' have
  696.     been added to this version. You DO NOT need to setup anything as far
  697.     as these new features are concerned, they will by default be setup to
  698.     post to ALL users, but you should take the time to look at them as
  699.     they can GREATLY enhance the flexibility of Rams.
  700.  
  701.  
  702.                                  INSTALLATION
  703.                                  ============
  704.  
  705.     Installation of RAMS could not be easier,  Unpack the main files into
  706.     a directory (C:\RAMS is the suggested directory).    Make a directory
  707.     to hold your message templates and unpack the SAMPLE.ZIP  into  that,
  708.     (the suggested directory is C:\RAMS\TEMPLATE).
  709.     Read the section entitled "Getting Started"  and  then  run the file
  710.     RAMSCFG.EXE to configure the program.
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                                 ---- 14 ----
  730.  
  731.                                GETTING STARTED
  732.                                ===============
  733.  
  734.     Before  configuring  RAMS  you will  need to  know a couple of basic
  735.     things about YOUR system:-
  736.  
  737.     1/. - The format and details of your Sysop message base(s).
  738.  
  739.     2/. - The format and details of User and local/echo message bases(s).
  740.  
  741.     That's it, as simple as that!!
  742.  
  743.     Ok,having unpacked your files into the relevant directories you will
  744.     now need to setup the "System" section of the configuration.
  745.     Make sure that RAMSCFG.EXE and RAMS.EXE are installed into the  SAME
  746.     directory otherwise RAMS will not be able to read it's configuration
  747.     file once it is created.
  748.     Run the file RAMSCFG.EXE,  press  either  F10 and move the highlight
  749.     bar to "System", OR, just press Alt-S, then press ENTER.
  750.     You have then got two options - System or MSG's Setup...
  751.     Press  Enter on  the System option.   You  are  now presented with a
  752.     screen with several input boxes for Sysop Name,   System Name etc...
  753.     You will note that RAMSCFG has placed  you directly  in the field to
  754.     enter the sysop's name,just type in your name and the input box will
  755.     clear of the default text for you.   The  input routines in RAMS all
  756.     work the same way, type to edit, Tab or Enter to Skip,  and Space to
  757.     toggle the multi - choice options.
  758.     Having entered your name by pressing Enter this will be saved and you
  759.     are in the system name entry field, all these entry fields work in the
  760.     same way.
  761.     Having setup the five fields in  the system  menu  you need to  press
  762.     escape to close the window,  select MSG's setup and press enter.  This
  763.     is the default message setup, in other words if you forget to specify
  764.     a message  area for  a  particular  message then RAMS will default to
  765.     these areas.
  766.     Use space to toggle between  Jam/Hudson  and then press enter,  enter
  767.     the msgs base number (Hudson) or the message base path/filename (JAM),
  768.     press enter and you are moved to the  User section of the menu  which
  769.     is identical.
  770.  
  771.     Having completed that press Escape to exit the menu,then use the left
  772.     and  right arrow keys to select the message menu  you require,  setup
  773.     the required messages,(full details can be found in the Message Setup
  774.     section),  then press Alt-X to  exit the setup program,  you  will be
  775.     prompted to save your configuration, choose Yes and your ready to run
  776.     Rams for the first time!
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.                                 ---- 15 ----
  786.  
  787.                               THE MENU OPTIONS
  788.                               ================
  789.  
  790.     There are many menu  options in RAMSCFG, They are very simple to use,
  791.     an in - depth guide to these options now follows:=
  792.  
  793.     MAIN SCREEN
  794.     -----------
  795.  
  796.     Options are as follows:-
  797.  
  798.     _        -  About RAMS,  this  simply pops a box telling you who the
  799.                 authors are and what the program is called!
  800.  
  801.     System   -  This is the only part of the program that HAS to be setup.
  802.                 It is in this section where you will enter your name, the
  803.                 System name, Logging options, and set the default message
  804.                 bases.
  805.                 PLEASE NOTE! You CANNOT access ANY of the other menus until
  806.                 you have setup the System menu.
  807.  
  808.     Normal   -  Normal message types.  A  NORMAL message type is one that
  809.                 is sent when RAMS is run  after  a caller has been on the
  810.                 BBS.   These  messages include  Welcome messages,  Upload
  811.                 messages, Carrier drop messages, and more..
  812.  
  813.     Midnight -  Midnight message types.   A  MIDNIGHT message type is one
  814.                 that is sent the first time RAMS  is  run AFTER midnight.
  815.                 There  are   no  command  line  parameters  or   external
  816.                 utilities required with RAMS,  RAMS  checks  the time and
  817.                 date when it is run and performs it's  "daily or midnight"
  818.                 events when they are required. Midnight messages for this
  819.                 reason are messages that require to be posted on a daily,
  820.                 or greater timescale and include messages such as Regular
  821.                 post, Monthly post, Subs expiry and much more.  Also from
  822.                 this menu you can setup the Daily and Weekly reports.
  823.  
  824.     Help     -  RAMSCFG has an extensive online help facility which  will
  825.                 take you to the relevant section of this document file,so
  826.                 as you see, there is no having to close the program  down
  827.                 if you want to refer to the docs, just press F1 from just
  828.                 about anywhere in the program.
  829.                 The help file viewer supports the following commands:=
  830.  
  831.                 PgDn      -   Down a page
  832.  
  833.                 PgUp      -   Up a page
  834.  
  835.                 Home      -   Go to the start of the document
  836.  
  837.                 End       -   Go to the end of the document
  838.  
  839.                 Up & Down Arrow keys give full scrolling.
  840.  
  841.                                 ---- 16 ----
  842.    cont...
  843.  
  844.     Along the bottom of the screen
  845.     ------------------------------
  846.     F1       -  Brings  up  the  help  from anywhere  in the program (see
  847.                 above)
  848.  
  849.     Alt - X  -  Exit the program. You are prompted upon exit to save your
  850.                 configuration.
  851.                 NOTE:=
  852.                 It is ONLY at this point that  any  changes you have made
  853.                 will be written to the configuration file!!!
  854.  
  855.     F2       -  Save.  Exactly what it says...SAVE the data,  this option
  856.                 will overwrite your  configuration  file  WITHOUT warning
  857.                 and is more for piece of mind.ie. If you are worried that
  858.                 the system may lockup or crash for some reason then  this
  859.                 will effect a data save.
  860.  
  861.     F10      -  Activates the top menu bar. Once activated press left and
  862.                 right arrow keys to highlight the option you require, and
  863.                 then enter to select that option.
  864.  
  865.     Escape   -  Escape will always close the menus one stage,  back down
  866.                 as far as the opening screen,where upon Alt - X will exit.
  867.  
  868.  
  869.     THE SYSTEM MENU
  870.     ---------------
  871.  
  872.     System Setup   -  This is compulsory!   In  this menu is  the section
  873.                       where you enter the things RAMS MUST  know about in
  874.                       order to function.
  875.                       From within this menu you will  enter  your name as
  876.                       you wish RAMS to know it,  your  system name as you
  877.                       wish RAMS to know it. You will need to confirm  the
  878.                       path to CONFIG.RA,  set your logging  options,  and
  879.                       tell RAMS where you have stored the message template
  880.                       files.
  881.  
  882.     MSG's Setup     -  This is the default message setup,in other words if
  883.                       you   forget  to  specify  a  message  area  for  a
  884.                       particular  message then RAMS will default to these
  885.                       areas.   It  is  advisable that before setting this
  886.                       section up  that  you  know which  message base you
  887.                       will be  using for your  default  sysop and default
  888.                       user message bases.
  889.  
  890.     THE NORMAL MENU AND MIDNIGHT MENU
  891.     ---------------------------------
  892.     As these are really  about setting  the  messages up  the option from
  893.     these menus will be discussed  under  the  headings for  the  various
  894.     message types.
  895.  
  896.  
  897.                                 ---- 17 ----
  898.  
  899.                            THE SYSTEM SETUP OPTIONS
  900.                            ========================
  901.  
  902.  
  903.  
  904.     SYSOP NAME
  905.     ----------
  906.     This is your name as you wish your users to see it.
  907.     Please note that this MUST also match the name you give for your  key
  908.     when you register RAMS.
  909.     It MUST also match the Sysop name in RA config too!
  910.  
  911.  
  912.     SYSTEM NAME
  913.     -----------
  914.     This is the name you wish your system to be known by.
  915.     Please note that unlike some programs your system name is  irrelevant
  916.     as far as a registration key is concerned, so if you decide to change
  917.     your system name there  will  be no  need  to go through the problems
  918.     and inconveniences of getting a new key.
  919.     Rams checks the Sysop name in Config.RA anyway and that MUST match the
  920.     name stored in the key or Rams will abort with an error, so no-one can
  921.     use another persons key unless they also use that persons  name as the
  922.     Sysop name in RA!!
  923.  
  924.  
  925.     TEMPLATE DIRECTORY
  926.     ------------------
  927.     This  is the  directory where  RAMS  expects  to  find  it's  message
  928.     template files.
  929.     This is where  you  should unpack the  SAMPLE.ZIP  archive  contained
  930.     inside the main  distribution archive.  It  contains  example message
  931.     templates for *MOST* of the messages available in Rams.
  932.     You  may  if  you wish set this to your main RAMS directory,   but  a
  933.     sub-directory is recommended as with all messages active this  version
  934.     (RAMS) allows for 150 PLUS message templates!!!
  935.     NOTE - This Directory MUST be set BEFORE you may activate ANY message!
  936.  
  937.  
  938.     LOG PATH/FILENAME
  939.     -----------------
  940.     Like all good programs RAMS keeps  a  logfile of  it's activities  so
  941.     that you can easily monitor that RAMS is performing as you expect. If
  942.     you leave this field as default then RAMS will create it's logfile in
  943.     it's own system directory.   You  may however  prefer the practice of
  944.     keeping all your logfiles together,  in which case enter in here the
  945.     full path and filename you wish to call your log.
  946.     For EXAMPLE C:\LOGS\RAMS.LOG
  947.     NOTE.You can use *N as a node variable  (exactly as you can in RA) so
  948.     using a log file name of RAMS*N.LOG  would  generate a logfile called
  949.     RAMS1.LOG for node 1, RAMS2.LOG for node 2 etc. etc.
  950.  
  951.  
  952.  
  953.                                 ---- 18 ----
  954.  
  955.     PATH TO CONFIG.RA
  956.     -----------------
  957.     Because of the variance in multinode systems we found it necessary to
  958.     confirm where your CONFIG.RA file will be for the node you are  going
  959.     to be setting up for.  RAMSCFG will attempt to find this from the  RA
  960.     system environment variable.  If this is correct then press enter  to
  961.     confirm or edit as required.
  962.  
  963.  
  964.  
  965.  
  966.                         THE MESSAGE MENU OPTIONS
  967.                         ========================
  968.  
  969.     The message menus within RAMSCFG are set out as a template.  It is by
  970.     doing this that as you become accustomed to setting  one  message type
  971.     up  you will  need  very  little  extra  knowledge  to  setup further
  972.     messages.  Some message types have "extra" options,    some have less
  973.     options, but the layout remains the same, the same keystrokes etc...
  974.  
  975.     These options are:=
  976.  
  977.  
  978.     ACTIVE   [ ]
  979.     ------------
  980.     Press Space to toggle the "X" in the box, BLANK is INACTIVE,  "X"  is
  981.     ACTIVE.  This is basically the On/Off switch for the message,   so if
  982.     you don't require to set the message up leave this box blank and exit
  983.     the menu.  If  however you wish  to activate this message then toggle
  984.     the box to show "X" and press enter to confirm.
  985.     NOTE - Rams will ONLY post the message if it is set as ACTIVE
  986.  
  987.     *IMPORTANT NOTE*
  988.     The RAMS cnfiguration program will NOT allow you to activate a message
  989.     UNTIL the message template directory has been setup in the sytem setup
  990.     menu!
  991.  
  992.     AREA TYPE
  993.     ---------
  994.     Press Space to toggle between the Hudson and Jam message base format.
  995.     For the Hudson message base the MsgBase field will show as  a three -
  996.     digit entry box,  if Jam is selected a full width path/filename entry
  997.     field will appear.
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.                                 ---- 19 ----
  1010.  
  1011.     LOCAL/ECHO
  1012.     ----------
  1013.     Press Space to toggle between Local and Echo messages.   RAMS has the
  1014.     ability to send both the sysop and the user messages as local.    Why
  1015.     the option to send the sysop message as an echo message?     Well the
  1016.     sysop may  be going away and may wish to use RAMS to check his system
  1017.     remotely!.
  1018.     If this field is  set   to  local  then pressing enter will skip this
  1019.     option.
  1020.     If this field is toggled to echo then pressing enter will take you to
  1021.     an "EchoMail Information" menu where you will be prompted for the aka
  1022.     for the message area and to enter an origin line.
  1023.     Please refer to the "Echomail Information" section for more details.
  1024.  
  1025.  
  1026.  
  1027.  
  1028.     TEMPLATE FILENAME
  1029.     -----------------
  1030.     This  is the  message  filename  for this  particular  section of the
  1031.     message i.e.. one for the sysop and one for the user.    This must be a
  1032.     valid filename complete with the extension. RAMS expects to find this
  1033.     message file in it's template directory.    The file itself is just a
  1034.     simple Ascii text file which may contain METASTRINGS which RAMS  will
  1035.     replace with applicable system information at run-time.
  1036.     The  metastrings  will  allow  you  to  insert  extra  user  specific
  1037.     information into each message generated by Rams...   Such as username,
  1038.     Sysopname, bbsname,date,time and lots of other details. This makes it
  1039.     relatively  easy  to  use just  one  message  template file  for each
  1040.     message and Rams will take care of the detail.
  1041.     There are almost ONE HUNDRED metastrings available for you to use!
  1042.     (for more information on Metastrings please refer to the section that
  1043.     is headed "METASTRINGS").
  1044.     Please note that although the configuration program  will  default to
  1045.     certain filenames that it is YOUR responsibility to  make  sure  that
  1046.     these files exist and are edited to suit your needs!!!
  1047.     Both the filename AND the extension are entirely optional  -  you may
  1048.     call them whatever you wish,you may if you wish even specify the same
  1049.     filename for more than one message  -  handy for regular posts  where
  1050.     perhaps you may wish to have for example your  BBS  advert  posted in
  1051.     more than one mail network under different aka's.
  1052.  
  1053.     You DO NOT  have  to  accept  the default filenames, you can call the
  1054.     templates whatever you want.  The  default names are only provided so
  1055.     that they match the example  message  template  files provided in the
  1056.     release archive.
  1057.  
  1058.     RAMSCFG has an inbuit template editor - see section later..
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.                                 ---- 20 ----
  1066.  
  1067.  
  1068.     MSG AREA
  1069.     --------
  1070.     This is the message area that you wish to post your message into.  In
  1071.     the  case  of  HUDSON  this  is the THREE DIGIT number for the HUDSON
  1072.     message base.
  1073.     In the case of a JAM area this is the FULL path  and  filename to the
  1074.     JAM message file WITHOUT any extension.
  1075.     NOTE - This is the filename, NOT the Echotag! RAMS cares not what the
  1076.     Echotag is!!!
  1077.  
  1078.  
  1079.  
  1080.     SUBJECT
  1081.     -------
  1082.     Each message has a subject line where you may specify the subject  of
  1083.     the message.     RAMS does have default subjects built in and if this
  1084.     field is left blank then RAMS  will  insert  the default subject line
  1085.     for that particular message.
  1086.  
  1087.  
  1088.  
  1089.     POST TO
  1090.     -------
  1091.     This option is available  ONLY  in the Regular,  Monthly,  and Yearly
  1092.     messages.   This  allows you to  address your message to a particular
  1093.     person, or simply "All".
  1094.     Also in this field you may use the '@ALL' macro. If @ALL (without the
  1095.     quotes!) is found in the 'Post to' field  it will  generate a message
  1096.     to EVERY user, so it may take a while!  It may also generate a LOT of
  1097.     MSG's!    These  MSG's  will  ONLY  be posted if the user satisfies the
  1098.     conditions you have specified for the msg. concerned.
  1099.     @ALL is NOT case sensitive... You can use @ALL, @all, @All or whatever.
  1100.  
  1101.  
  1102.  
  1103.     CALLS/TIMES ON
  1104.     --------------
  1105.     This entry field in the  Times on  message allows you  to specify the
  1106.     number of calls made to the system by the user that has just been  on
  1107.     line, and in the Nth Call template the number of calls. You may enter
  1108.     a value between 1 and 999.
  1109.  
  1110.  
  1111.     KEYWORD
  1112.     -------
  1113.     Entry in this field can be numerical,  alphabetic,  and in  upper  or
  1114.     lower case,  but  remember that  it  MUST  be an  EXACT  match to the
  1115.     keystring that you wish RAMS to search for.
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                 ---- 21 ----
  1122.  
  1123.     DAY OF WEEK TO POST
  1124.     -------------------
  1125.     Only found in the Weekly report template, this allows you to  specify
  1126.     which day of the week you would like  to  receive your  weekly report
  1127.     (if active).  Arrow keys left and right to move  the "highlight"  and
  1128.     enter to select.
  1129.  
  1130.  
  1131.  
  1132.     FREQUENCY
  1133.     ---------
  1134.     Only found in the  Regular  post  message  allows  you to specify the
  1135.     number of days between posts!
  1136.  
  1137.  
  1138.  
  1139.     DATE TO POST
  1140.     ------------
  1141.     Only found in the Monthly message type.   This  allows you to specify
  1142.     the date in the month to post i.e.. 2nd, or 17th, or 25th....
  1143.     NOTE - If you specify for example 30 ( 30th of the month ) then  RAMS
  1144.     will not post in February (28/29 days in this month)...
  1145.  
  1146.  
  1147.  
  1148.     MONTH & DAY
  1149.     -----------
  1150.     Used in the Yearly message.   Enter the date in these fields that you
  1151.     wish RAMS to post on.
  1152.     NOTE - RAMS makes no validation of that date,  so if you entered  the
  1153.     values of 4 (April) and 31(31st) then the message would NEVER be sent
  1154.     as there are only 30 days in April!!
  1155.  
  1156.  
  1157.     DAYS TO EXPIRE
  1158.     --------------
  1159.     This is found  on the  Subscription  message template and is used  to
  1160.     specify the number of days prior to a subscription  expiry to  post a
  1161.     message to a user. Setting a value of say 90 in this field will cause
  1162.     RAMS to send a message 90 days before a subscription expires,  please
  1163.     note that RAMS will only send this message on the 90th day before the
  1164.     expiry date..... Setting this message will not warn  users with  less
  1165.     than the specified number of days to receive this message...so if say
  1166.     on the 90th day before a subscription expiry RAMS is not run,    then
  1167.     that user will NOT receive a message....
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.                                 ---- 22 ----
  1178.  
  1179.     ACTIVATE DOOR FEATURE
  1180.     ---------------------
  1181.     This field is common to ALL the Carrier Drop message templates,   and
  1182.     can be accessed from any one of them!
  1183.     On activating this field another menu appears where you may enter  up
  1184.     to ten  " DOS shell : "  or  " Exit at errorlevel " strings that will
  1185.     uniquely identify a door that does NOT permit a  logoff from  within.
  1186.     Please  make sure that the string entered  here EXACTLY  matches  the
  1187.     entry in RA's logfile!!   CASE IS IMPORTANT!!!
  1188.     The list of Doors that DO NOT  allow  a  user to logoff needs only be
  1189.     setup for ONE carrier drop message,  the SAME setup is applied to ALL
  1190.     carrier drop messages.
  1191.  
  1192.     Some examples:-
  1193.  
  1194.          DOS shell : *C /c c:\ra\acbj.bat *M
  1195.  
  1196.          DOS shell : C:\RA\ABC.EXE *M
  1197.  
  1198.          Dos shell : C:\RA\DOORS\TETRA\TETRA.EXE *M
  1199.  
  1200.          DOS shell : *C /c c:\ra\cs.bat *M
  1201.  
  1202.          DOS shell : *C /C: C:\RA\LISA.BAT *M
  1203.  
  1204.          DOS shell : *C /c c:\ra\4square.bat *M
  1205.  
  1206.          DOS shell : *C /c C:\RA\DOORS\WHEEL\MCSPIN.EXE /N *N *M
  1207.  
  1208.      Any UNIQUE part of the above strings would suffice!!
  1209.  
  1210.      ie. MCSPIN.EXE , acbj.bat,
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.                                 ---- 23 ----
  1234.  
  1235.                             ECHOMAIL INFORMATION
  1236.                             ====================
  1237.  
  1238.     RAMS is compatible with a full 4D mail address which means that point
  1239.     numbers are acceptable.  In this way sysop's who use point  addresses
  1240.     can still use RAMS echomail features,   or a sysop who wishes to post
  1241.     from a point address can do so.
  1242.     If a message is set to Echo from the Echo/Local option then the input
  1243.     box for entering this information will appear.
  1244.  
  1245.     There are only two options on this menu:=
  1246.  
  1247.     NODE NUMBER   -  This is split into four parts, enter your number and
  1248.                      press enter.  Enter will skip the point field if not
  1249.                      required.
  1250.  
  1251.     ORIGIN LINE   -  This is the origin line that you wish RAMS to append
  1252.                      to the end of each message.  It may be your BBS name
  1253.                      and phone number or any other information  that  you
  1254.                      wish to place there!
  1255.                NOTE. DO NOT add your node number to the origin line, Rams
  1256.                ----  will automatically append  it when  it  generates an
  1257.                      echo message.
  1258.  
  1259.  
  1260.  
  1261.                              CONDITIONS/ACTIONS
  1262.                              ==================
  1263.  
  1264.     Because of the nature  and  the  power of these  options this section
  1265.     will be split into three sections, Conditions,  Actions,  and then  a
  1266.     further section entitled  " Conditions/Actions  - How to get the most
  1267.     out of them".
  1268.  
  1269.     At the moment RAMS supports security level changes, Flag support, age,
  1270.     Group, Language, etc...
  1271.  
  1272.     If the user does NOT meet  the  'Condition'  for a particular message
  1273.     RAMS will NOT post a message to the user.  Similarly,  'Actions' will
  1274.     ONLY be performed IF a message is sent.
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.                                 ---- 24 ----
  1290.    cont...
  1291.  
  1292.     CONDITIONS - SECURITY LEVEL
  1293.     ---------------------------
  1294.     By default these values are set at 0 for min.level and 65535 for max.
  1295.     level that basically tells Rams to post messages to ALL users. If you
  1296.     only want a particular message to be posted to users with a sec.level
  1297.     of 10, set BOTH the minimum AND maximum values to 10...If you want to
  1298.     post to any users between 10-50 INCLUSIVE,  set the min.  level to 10
  1299.     and the max. level to 50.
  1300.     REMEMBER, these values are INCLUSIVE.  So  if  you  wanted to post to
  1301.     users ABOVE sec.  level 10 and NOT to users of level 10 or below, you
  1302.     would set the min value to 11 and the max. to 65535.
  1303.  
  1304.  
  1305.     CONDITIONS - AGE
  1306.     ----------------
  1307.     By  default these values are set at 0 for the  minimum  age and at 99
  1308.     for the maximum age, but you can enter any values you wish as long as
  1309.     they are between 0 and 99... Rams will ONLY post a msg. to the user(s)
  1310.     IF they fall between the ages you have entered.  So, if you only want
  1311.     a message to be posted to users who are OVER 18,set the minimum value
  1312.     to 18 and leave the maximum as 99...   Then any user that is BELOW 18
  1313.     years of age will NOT get that particular msg. PLEASE NOTE, if you do
  1314.     not have your system setup to ask a user his birthday at first logon,
  1315.     OR if the users birthday is  blank in their user record the age  will
  1316.     NOT be taken into account and the message WILL be posted.
  1317.  
  1318.  
  1319.     CONDITIONS - FLAGS
  1320.     ------------------
  1321.     By default the flags are all set to '-' which means that Rams will
  1322.     IGNORE any user flags and post the message concerned. However, you can
  1323.     select either '-', 'O', or 'X' by pressing the spacebar to toggle the
  1324.     entry to the desired one. If you select 'O', then that user flag MUST
  1325.     be OFF before Rams will post the message, if you select 'X' then the
  1326.     user flag MUST be ON for Rams to post the message. Selecting '-' means
  1327.     that Rams will IGNORE that particular flag irrespective of what it is
  1328.     set to in the user record.
  1329.  
  1330.  
  1331.     CONDITIONS - GROUP
  1332.     ------------------
  1333.     By default Rams will post to ALL user groups. However, you can select
  1334.     any valid group in the range 0-255. If you enter 1, Rams will ONLY
  1335.     post that message to a user in Group 1 etc... You can select ALL by
  1336.     either typing the word 'ALL' (without the quotes!) OR by entering a
  1337.     value of 256.
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.                                 ---- 25 ----
  1346.    cont...
  1347.  
  1348.     CONDITIONS - SEX
  1349.     ----------------
  1350.     By default Rams will post to BOTH female AND male users. However, you
  1351.     can specify that a particular message is only posted to ONE sex or the
  1352.     other by pressing the spacebar to toggle the condition to either 'Male'
  1353.     'Female, or 'Both'.
  1354.  
  1355.  
  1356.     CONDITIONS - LANGUAGE
  1357.     ---------------------
  1358.     By default Rams will post to users with ANY language selected. However,
  1359.     you can selesct that Rams should only post to users with a specific
  1360.     language by entering their langauge number here. You can have any valid
  1361.     language in the range 0-255. To select ALL, either type the word 'ALL'
  1362.     (Without the quotes!), OR enter a value of 256.
  1363.  
  1364.  
  1365.     ACTIONS - Alter SecLevel.
  1366.     -------
  1367.     In this section you have four options:=
  1368.  
  1369.     NONE      - This is the DEFAULT value...In other words Rams WILL post
  1370.                 the message if the user meets the  conditions set for it,
  1371.                 but it will NOT alter his seclevel.
  1372.  
  1373.  
  1374.     CHANGE    - Change seclevel from  the users old  setting to the  new
  1375.                 level you specify here.
  1376.                 i.e., setting it to a value of 50 will cause Rams to change
  1377.                 the users security level from  it's  current level to the
  1378.                 new one you have assigned.
  1379.                 This WILL  change  ONLY if the user  meets the conditions
  1380.                 for posting the message,   and it WILL RESET  his  level,
  1381.                 whether that be up OR down, to the new level.
  1382.  
  1383.     INCREASE  - First  you  specify an  amount  to INCREMENT  the   users
  1384.                 seclevel by, and a MAXIMUM value this can go to.
  1385.                 So for example,setting the Increment amount to 10 and the
  1386.                 maximum amount to 100  would  cause  Rams to increase the
  1387.                 users security  by 10 everytime it  posted  this message,
  1388.                 UNTIL the user reached the MAXIMUM level specified. After
  1389.                 that situation was reached, Rams would still post the msg.
  1390.                 if necessary,   but would NOT increase the users seclevel
  1391.                 beyond the maximum value you had defined.
  1392.                 Once the maximum level is reached, the message will still
  1393.                 be posted (if the user still meets the conditions for the
  1394.                 message) but his seclevel will NOT be altered any further.
  1395.  
  1396.  
  1397.  
  1398.  
  1399.                                 ---- 26 ----
  1400.    cont...
  1401.  
  1402.     DECREASE  - First  you  specify an  amount  to DECREMENT  the   users
  1403.                 seclevel by, and a MINIMUM value this can go to.
  1404.                 So for example,setting the Decrement amount to 5  and the
  1405.                 minimum amount to 10   would  cause  Rams to decrease the
  1406.                 users security  by 5  everytime it  posted  this message,
  1407.                 UNTIL the user reached the MINIMUM level specified. After
  1408.                 that situation was reached, Rams would still post the msg.
  1409.                 if necessary,   but would NOT decrease the users seclevel
  1410.                 below the minimum value you had defined.
  1411.                 Once the minimum level is reached, the message will still
  1412.                 be posted (if the user still meets the conditions for the
  1413.                 message) but his seclevel will NOT be altered any further.
  1414.  
  1415.  
  1416.     ACTIONS - FLAGS
  1417.     ---------------
  1418.     By default Rams will NOT change any user flags, but if a message is
  1419.     posted it can do any of the following:
  1420.  
  1421.       O  - Turn user flag OFF
  1422.       X  - Turn user flag ON
  1423.       T  - Toggle user flag. ie. if it's ON turn it OFF, if it's OFF turn
  1424.            it ON.
  1425.       -  - IGNORE flag. ie. DO NOT change it.
  1426.  
  1427.     By default ALL flags are set to '-' so that nothing is changed by Rams.
  1428.  
  1429.  
  1430.     ACTIONS - GROUP
  1431.     ---------------
  1432.     By default, Rams will NOT change the users 'Group'. However, you can
  1433.     specify ANY valid user group in the range 0-255 and Rams will change
  1434.     it to the specified level IF the message is posted. To set it to the
  1435.     default of 'N/C' (No Change), either type 'N/C' (without the quotes!)
  1436.     OR enter a value of 256.
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.                                 ---- 27 ----
  1458.  
  1459.                            MESSAGE TEMPLATE EDITOR
  1460.                            =======================
  1461.  
  1462.     RAMS has an inbuilt message template editor that can be invoked from
  1463.     any of the message template screens by pressing the "F5" key.   RAMS
  1464.     will load in the message template as defined in the template filename
  1465.     that is applicable to the section of the message setup template  that
  1466.     you are in. ie.. Sysops part of the setup template will  load  in the
  1467.     Sysop's message template,  The User's section will load in the User's
  1468.     template...
  1469.  
  1470.     KEYS
  1471.     ----
  1472.  
  1473.     F1 - Help
  1474.  
  1475.     Escape - Exit
  1476.  
  1477.     F2 - Save
  1478.  
  1479.     Alt-F2 - Save As. Please note that the save as option WILL update the
  1480.                       template name that you have setup in RAMS!!!
  1481.  
  1482.     F5 - Invokes a "pick list" of metastrings.    The template editor will
  1483.          display a different set for the sysop and user message templates.
  1484.          Use the up/down arrow keys to select a metastring. Press enter to
  1485.          graft this into your message at the cursor position.  Escape will
  1486.          abort!
  1487.  
  1488.     Ctrl+y - delete a line.
  1489.  
  1490.     Home - start of the message.
  1491.  
  1492.     End - end of the message.
  1493.  
  1494.     PgUp/PgDn - page up or down as appropriate.
  1495.  
  1496.     If a file exists of the same name in your template directory then please
  1497.     note that a ????????.BAK file WILL be created.
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.                                 ---- 28 ----
  1514.  
  1515.                                EXCLUDING USERS
  1516.                                ===============
  1517.  
  1518.     There may be some users that you wish to exclude  from  getting  any
  1519.     messages or having RAMS alter their security status etc..   for this
  1520.     purpose provision has been made for an EXCLUDE.CTL file...  This can
  1521.     be used  to  specify a list of users that should  NOT  be  sent  any
  1522.     messages. One name per line, and the EXCLUDE.CTL file MUST be in the
  1523.     same directory as RAMS.EXE
  1524.  
  1525.     For example:
  1526.  
  1527.     Eddy Matthews
  1528.     Andy Smith
  1529.     Steve Nutt
  1530.     etc.. etc..
  1531.  
  1532.     The list is NOT case sensitive...     If a user is found in this list
  1533.     he/she  will  NOT  be sent ANY user messages,  HOWEVER  'Information'
  1534.     messages to the Sysop WILL still be sent (if they are enabled) so you
  1535.     can still keep an eye on what these excluded users are up to...
  1536.     If you choose NOT to have an EXCLUDE.CTL file RAMS will report to the
  1537.     screen that this file is  NOT  found,  but  this  does NOT affect the
  1538.     running of the program in any way!
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.                                 ---- 29 ----
  1570.  
  1571.                   INSTALLING RAMS INTO YOUR BBS BATCHFILE
  1572.                   =======================================
  1573.  
  1574.     Installing RAMS into your BBS batch file is quite easy,   just follow
  1575.     these steps:
  1576.  
  1577.        1. Create a directory on your hard drive and extract all the files
  1578.           from the distribution archive into this directory.
  1579.  
  1580.           C:\RAMS is recommended and is assumed to be the directory you
  1581.                   have created.
  1582.  
  1583.  
  1584.        2. Read the document file!! (okay I know you are already :-))
  1585.  
  1586.        3. Run RAMSCFG.EXE to configure RAMS so that it sends the messages
  1587.           you require for your system.  You should have done this already
  1588.           as explained in the previous chapters on configuring RAMS.
  1589.           The RAMSCFG  program  has  a  built  in  help system which will
  1590.           explain what is necessary in  each  field in some detail so you
  1591.           can easily configure RAMS for your needs.
  1592.           Pressing the function key F1 will cause a pop up help window to
  1593.           appear which will  remind  you  of  the  information and format
  1594.           required by each field.
  1595.  
  1596.         N.B.
  1597.  
  1598.           It is IMPORTANT  that you should  move through each part of the
  1599.           configuration program in a careful and methodical way to ensure
  1600.           that you  DO  NOT  miss  anything  thereby  causing unnecessary
  1601.           problems for yourself later!
  1602.  
  1603.           If you are in any doubt:-
  1604.           READ THE SECTIONS EXPLAINING HOW TO CONFIGURE RAMS!
  1605.  
  1606.        4. Edit your BBS batch file  so  that it will run  RAMS after each
  1607.           user logs off your system.    This is not only so that RAMS can
  1608.           keep certain stats up to date  but  so  that  RAMS can send any
  1609.           messages required.
  1610.           It should be noted that *MOST* messages will be generated  when
  1611.           RAMS is run at this time.
  1612.  
  1613.            i.e.
  1614.  
  1615.              edit your batch file to include:
  1616.  
  1617.              <Your BBS batch file>
  1618.              <Error levels>
  1619.              Goto RAMS
  1620.  
  1621.  
  1622.  
  1623.  
  1624.                                 ---- 30 ----
  1625.   cont..
  1626.  
  1627.              :RAMS
  1628.              CD\RAMS
  1629.              RAMS
  1630.              Goto Start
  1631.              <batch file continues>
  1632.  
  1633.              As stated above, this MUST be in a section of your batch file
  1634.              that will be executed EVERY time a user logs off.
  1635.  
  1636.        5. There's NO extra command line parameters to  worry  about,   no
  1637.           midnight events, so there's NO  need  to make sure RAMS runs in
  1638.           your midnight event, although you MAY do so if you wish.
  1639.           What RAMS has is "Daily procedures".  These are when RAMS posts
  1640.           things like Regular posts, Birthday messages, Sysop reports.
  1641.           RAMS detects the FIRST time it is run EACH day and will perform
  1642.           these tasks then, and what's more it only takes a  few SECONDS.
  1643.           This is why RAMS does not require a midnight event.
  1644.  
  1645.     That's all there is to it!!
  1646.  
  1647.     RAMS is now ready to take over all those boring messages that a  busy
  1648.     Sysop needs to send on a regular basis......
  1649.  
  1650.     After configuring RAMS to your needs and running it for the first time
  1651.     the following files will be created:
  1652.  
  1653.         RAMS.LOG - Log file of RAMS's activity. This will be placed in the
  1654.                    directory RAMS was run from,  but  you  can specify the
  1655.                    directory  and  filename of your choice from within the
  1656.                    configuration program.   Please see the section of this
  1657.                    document about configuring RAMS for more info.
  1658.  
  1659.  
  1660.         RAMS.DAT - This is RAMS "working" file of information.
  1661.                    WARNING  -  deleting or tampering with this file in any
  1662.                    shape or form WILL affect the way RAMS will run!
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.                                 ---- 31 ----
  1682.  
  1683.  
  1684.     MULTILINE SYSTEMS
  1685.     -----------------
  1686.     Using the  RemoteAccess Automated Message System  (RAMS) in a multi-
  1687.     node configuration
  1688.  
  1689.     RAMS has built-in support for multi-node systems,  and  requires only
  1690.     minor modifications to its configuration to enable it to  be  used in
  1691.     this kind of environment.
  1692.  
  1693.     Before you begin, see the RemoteAccess  documentation  for details of
  1694.     how to install RA in a multi-node environment,   as RAMS will utilise
  1695.     the configuration for each node as required.
  1696.  
  1697.     Please note: It is important to use a different copy of RAMS for each
  1698.     node, since each will require different configuration data.   Failure
  1699.     to correctly configure RAMS in a multi-node environment MAY result in
  1700.     damage to your userbase - you've been warned!
  1701.  
  1702.     You should also ensure  that RAMS  keeps a different log file for each
  1703.     node.    To do this,  use the RAMSCFG.EXE  utility  to  instruct  RAMS
  1704.     accordingly.
  1705.  
  1706.     RAMS uses the DOS TASK  variable  to determine  on  which  node  it is
  1707.     running.
  1708.     So, for example, you could instruct RAMS to use 'C:\FD\LOGS\RAMS*N.LOG'.  This
  1709.     would append the current node (task) number to the log filename, which
  1710.     would produce a file named RAMS1.LOG in your C:\FD\LOGS\ directory.
  1711.  
  1712.     You must also tell RAMS where to look for the RA config files for each
  1713.     node.
  1714.     Since this will vary depending on how each node is configured,  it is
  1715.     not  possible  to  provide  specific information on this point.   For
  1716.     further details, see the RA documentation.
  1717.  
  1718.     Suffice it to say that RAMS needs to know where the CONFIG.RA file is
  1719.     for the current node.
  1720.  
  1721.     So,for example, if you wanted to use RAMS on node #1, you could point
  1722.     RAMS to C:\RA\NODE1\ for the RA configuration.   It is very important
  1723.     that this point is clearly understood before you run RAMS in a multi-
  1724.     node environment,   since RAMS needs specific information  from  your
  1725.     RA.CFG file to function correctly.
  1726.  
  1727.     You must also set the DOS 'TASK' variable to the current node number.
  1728.     For  further  details on  this point,  see  your  operating  system's
  1729.     reference guide.
  1730.  
  1731.     If you attempt to run RAMS when configured  for multi-node operation,
  1732.     before setting the 'TASK' variable, RAMS will generate the  following
  1733.     error message:
  1734.  
  1735.  
  1736.  
  1737.                                 ---- 32 ----
  1738.    cont....
  1739.  
  1740.     The RA LogFile Cannot be opened
  1741.  
  1742.     Either the path/logfile defined in Config.RA doesn't exist, OR the RA
  1743.     log is locked by another process...
  1744.  
  1745.     RAMS Aborting!
  1746.  
  1747.     If you run both your nodes on the same machine,you can set the 'TASK'
  1748.     variable via a command-line  switch in the batch file which brings up
  1749.     your system as in the following example:
  1750.  
  1751.     @ECHO OFF
  1752.     CLS
  1753.     SET %TASK=1
  1754.     CD \RA
  1755.     RA 1 <switch> <switch> ETC. ETC. ETC...
  1756.  
  1757.     The number 1 on the above command line  defines  the 'TASK' variable,
  1758.     and assigns it a value of 1.  RAMS will then use this value to append
  1759.     to the log file it creates.
  1760.  
  1761.     That's really all there is to say regarding multi-node systems,   see
  1762.     your RA documentation for more details.
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.                                 ---- 33 ----
  1794.  
  1795.                            METASTRINGS USED BY RAMS
  1796.                            ========================
  1797.  
  1798.     In the file SAMPLE.ZIP  you  will  find  some example text files  for
  1799.     RAMS to use.
  1800.     These files are examples  only  and  you are free to edit them as you
  1801.     wish so they are more compatible with your system.      The files are
  1802.     plain ascii text,   and  are  used  by  RAMS  to generate its various
  1803.     messages to users/sysop etc. etc.
  1804.  
  1805.     If you examine  these  files  you  will see they contain lots of meta
  1806.     strings, such as %USERNAME% ,   these strings are automatically  read
  1807.     by RAMS and are replaced by your systems/users details.In the example
  1808.     given (%USERNAME%) RAMS would insert the name of the user as read from
  1809.     your BBS users file/s.
  1810.  
  1811.     The following is a list of  all  meta  strings currently available in
  1812.     RAMS. They ARE case sensitive, so entering %bOArdnAMe% will NOT work!
  1813.     You  may  use  any of these meta strings in any text files you create
  1814.     for use with RAMS, subject to the limitations of that metastring,
  1815.     Please note the usage specified in the descriptions!
  1816.  
  1817.     !! IMPORTANT !!
  1818.     ---------------
  1819.     Metastrings MUST be enclosed by % signs in order to function,
  1820.     i.e. Program must be entered as %Program% in any message  you wish to
  1821.     use it in.... The same is true for ALL other metastrings.  Entering a
  1822.     metastring without enclosing it by % signs  will  mean  RAMS will NOT
  1823.     translate the string concerned.
  1824.  
  1825.  
  1826.     %FROM%              Specifies the From field
  1827.     %TO%                Specifies the To field
  1828.     %SUBJECT%           Specifies the subject
  1829.     %PRIVATE%           Toggles private flag (by default local messages
  1830.                         are set to PRIVATE and echo messages are set to
  1831.                         PUBLIC)
  1832.     %USERNAME%          Name of User
  1833.     %SYSOPNAME%         Name of Sysop
  1834.     %DATE%              The date that RAMS posted the message
  1835.     %TIME%              The time that RAMS posted the message
  1836.     %BBSNAME%           Name of BBS system
  1837.     %SYSOPFIRST%        Sysop's first name
  1838.     %USERFIRST%         User's first name
  1839.     %DAYOFWEEK%         The day of the week that the message was generated
  1840.     %DATAPHONE%         The data phone number of the user
  1841.     %VOICEPHONE%        The voice phone number of the user
  1842.     %HANDLE%            The users handle
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.                                 ---- 34 ----
  1850.  
  1851.     metastrings cont....
  1852.  
  1853.     %ADDRESS1%          Address line one in the users record
  1854.     %ADDRESS2%          Address line two in the users record
  1855.     %ADDRESS3%          Address line three in the users record
  1856.     %USERNUMBER%        The number of the user in RA's userbase
  1857.     %AGE%               The User's age in years..ie.21,35,52...etc..
  1858.     %DOBDAY%            The DAY of the Users Date Of Birth. ie 01-31
  1859.     %DOBMONTH%          The MONTH of the Users Date Of Birth. i.e. 01-12
  1860.     %DOBYEAR%           The YEAR of the Users Date of Birth in two digit
  1861.                         form. 00-99
  1862.     %UPLOAD#%           Total Number of files uploaded by user,    Please
  1863.                         note this is NOT the number  of files uploaded in
  1864.                         the users last call,  but  the TOTAL  he/she  has
  1865.                         uploaded to your system.
  1866.     %DOWNLOAD#%         Total number of files downloaded by user,  Please
  1867.                         note this is NOT  the  number of files downloaded
  1868.                         in the users last call,  but the TOTAL he/she has
  1869.                         downloaded from your system.
  1870.     %DOWNLOADK%         Similar to %DOWNLOAD#%,   except that this is the
  1871.                         TOTAL Kb that the user has downloaded from your
  1872.                         system.
  1873.     %UPLOADK%           Similar to %UPLOAD#%,  except  that  this  is the
  1874.                         TOTAL Kb  that  the  user has  uploaded  to  your
  1875.                         system.
  1876.     %PASSWORD%          This can ONLY be used in the WATCHDOG messages and
  1877.                         will be translated to a list of  all the passwords
  1878.                         that were tried before RA  kicked the user off for
  1879.                         exceeding the maximum number of attempts.  Because
  1880.                         of the way RAMS has to process this  line multiple
  1881.                         times to list all the passwords  you  should place
  1882.                         this  metastring  on  it's  own  line  within  the
  1883.                         message text file.
  1884.         NOTE -  ANY other  text that is on the same line as the %PASSWORD%
  1885.                 metastring  will be  WIPED OUT by RAMS! An example of it's
  1886.                 use is shown in the SYSWDOG and USERWDOG message templates.
  1887.     %DOORNAME%          The  name  of the door the user was in when he/she
  1888.                         dropped  carrier.    This  currently  defaults  to
  1889.                         RemoteAccess,   but it will be expanded at a later
  1890.                         date to show the actual door name.    This meta is
  1891.                         only of use in the Carrier Drop messages.
  1892.     %UPLOAD%            Generates a list of filenames that were uploaded it
  1893.                         should  be  placed  on  a  separate  line   in  the
  1894.                         'Thankyou' MSG's, and will be translated to a  full
  1895.                         list by Rams when it generates the msg.
  1896.     %CALLS%             The  number of  calls made by the user to your BBS,
  1897.                         this can be used  in  any  msg.   you wish, but is
  1898.                         particularly useful in the 'Times On' msgs.
  1899.     %BIRTHDAYNAME%      This  can  only  be  used for  the sysop's message
  1900.                         template and will be replaced by  the names of all
  1901.                         the Users that RAMS has posted a  birthday message
  1902.                         to that day.
  1903.  
  1904.  
  1905.                                 ---- 35 ----
  1906.   cont...
  1907.  
  1908.     %DRIVEINFO%         This will give info on your hard drives.   Useful
  1909.                         for checking drive space etc.if you are away from
  1910.                         your machine. The %DRIVEINFO% metastring  MUST be
  1911.                         followed IMMEDIATELY by the drive letter you wish
  1912.                         to check.
  1913.                         i.e.. %DRIVEINFO%C will give details of drive C:,
  1914.                         %DRIVEINFO%E will give details of drive E: etc.
  1915.                         See the SYSREPT.MSG template for more info..
  1916.                         Please note, because of the  limitations  of  Dos
  1917.                         this metastring  will  ONLY  give correct info on
  1918.                         drives up to approx. 2Gb..   Anything larger than
  1919.                         that  will   cause  unpredictable  values  to  be
  1920.                         written to the msg.
  1921.         NOTE -  I don't  know  how this  will behave if used on a network
  1922.                 drive, a Ram disk, or on a doublespaced drive etc. It may
  1923.                 produce incorrect values in these circumstances... I have
  1924.                 no way of checking this myself!
  1925.     %WHOTO%             This  can  be  used in  the  sysop reports for the
  1926.                         Regular, Monthly, and Yearly messages. If the @All
  1927.                         macro is used  this  will generate a list of names
  1928.                         that the message/s were posted to...
  1929.     %USERMSGS%          Total number of User MSG's posted on the  previous
  1930.                         day..
  1931.     %SYSMSGS%           Total number of Sysop MSG's posted on the previous
  1932.                         day....
  1933.     %TOTALMSGS%         Total number of MSG's (Sysop + User) posted on the
  1934.                         previous day.
  1935.     %USERMONTHLYPOSTED% Total Monthly MSG's sent to users yesterday.
  1936.     %USERYEARLYPOSTED%  Total Yearly MSG's sent to users yesterday.
  1937.     %USERSUBSPOSTED%    Total Subscription expiry MSG's sent to users
  1938.                         yesterday.
  1939.     %USERBDAYWEEK%      Total birthday MSG's sent to users for the last week.
  1940.     %USERUPLDWEEK%      Total upload MSG's sent to users...
  1941.     %USERWELCWEEK%      Total Welcome MSG's sent to users...
  1942.     %USERWDOGWEEK%      Total Watchdog MSG's sent to users...
  1943.     %USERDROPWEEK%      Total Carrier drop MSG's sent to users...
  1944.     %USERTIMESONWEEK%   Total Times on MSG's sent to users...
  1945.     %USERKEYWORDWEEK%   Total Keyword MSG's sent to users...
  1946.     %USERNTHCALLWEEK%   Total Nth Call MSG's sent to users...
  1947.     %USERMONTHLYWEEK%   Total Monthly messages sent last week...
  1948.     %USERYEARLYWEEK%    Total yearly MSG's sent last week...
  1949.     %USERSUBSWEEK%      Total Subscription messages sent to users last week.
  1950.     %USERMSGSWEEK%      Total User messages sent last week.
  1951.     %USERTIMESONPOSTED% Number of TimesOn MSG's posted to users today.
  1952.     %USERNTHCALLPOSTED% Number of Nth Call MSG's posted to users today.
  1953.     %USERKEYWORDPOSTED% Number of User keyword msgs sent - ONLY for daily
  1954.                         report.
  1955.     %USERBDAYPOSTED%    The number of Birthday messages posted to the Users
  1956.                         yesterday.
  1957.     %USERUPLDPOSTED%    The number of 'Upload (thankyou)' messages sent to
  1958.                         users yesterday.
  1959.  
  1960.  
  1961.                                 ---- 36 ----
  1962.  cont....
  1963.  
  1964.     %USERWELCPOSTED%    The number of 'Welcome' messages sent to users
  1965.                         yesterday.
  1966.     %USERWDOGPOSTED%    The number of 'Watchdog' messages sent to users
  1967.                         yesterday.
  1968.     %USERDROPPOSTED%    The number of 'Carrier Drop' messages sent to users
  1969.                         yesterday.
  1970.     %USERREGULARWEEK%   Number of 'Regular' messages posted for the last week.
  1971.     %USERREGULARPOSTED% Number of 'Regular' messages posted yesterday.
  1972.     %SYSBDAYWEEK%       Total Sysop birthday reports sent last week.
  1973.     %SYSUPLDWEEK%       Total Sysop upload reports...
  1974.     %SYSWELCWEEK%       Total Sysop new user reports...
  1975.     %SYSWDOGWEEK%       Total Sysop watchdog reports...
  1976.     %SYSDROPWEEK%       Total Sysop Carrier drop reports...
  1977.     %SYSTIMESONWEEK%    Total Sysop Times on reports...
  1978.     %SYSKEYWORDWEEK%    Total Sysop Keyword reports...
  1979.     %SYSNTHCALLWEEK%    Total Sysop Nth Call reports...
  1980.     %SYSMONTHLYWEEK%    Total Sysop Monthly reports...
  1981.     %SYSYEARLYWEEK%     Total Sysop Yearly reports...
  1982.     %SYSSUBSWEEK%       Total Subscription expiry reports sent to Sysop
  1983.                         last week.
  1984.     %SYSMSGSWEEK%       Total Sysop MSG's sent last week.
  1985.     %SYSMONTHLYPOSTED%  Total Monthly reports sent to Sysop yesterday.
  1986.     %SYSYEARLYPOSTED%   Total Yearly reports sent to Sysop yesterday.
  1987.     %SYSSUBSPOSTED%     Total Subscription expiry reports sent to Sysop
  1988.                         Yesterday.
  1989.     %SYSNTHCALLPOSTED%  Number of Nth Call sysop reports posted today.
  1990.     %SYSTIMESONPOSTED%  Number of TimesOn MSG's posted to sysop today.
  1991.     %SYSKEYWORDPOSTED%  Number of Sysop keyword reports sent - ONLY for
  1992.                         daily report.
  1993.     %SYSBDAYPOSTED%     The number of Sysop birthday reports sent yesterday.
  1994.     %SYSUPLDPOSTED%     The number of Sysop 'Upload' reports sent yesterday.
  1995.     %SYSWELCPOSTED%     The number of Sysop 'New User' reports sent yesterday.
  1996.     %SYSWDOGPOSTED%     The number of Sysop 'Watchdog' reports sent yesterday.
  1997.     %SYSDROPPOSTED%     The number of Sysop 'Carrier Drop' reports sent
  1998.                         yesterday.
  1999.     %SYSDAILYPOSTED%    The number of Sysop 'Daily' reports sent yesterday.
  2000.     %SYSDAILYWEEK%      The number of Sysop 'Daily' reports sent for the
  2001.                         previous week.
  2002.     %SYSREGULARPOSTED%  Number of Sysop 'Regular' reports sent yesterday.
  2003.     %SYSREGULARWEEK%    Number of Sysop 'Regular' reports sent for the last
  2004.                         week.
  2005.     %TOTALMSGSWEEK%     Total User AND Sysop MSG's sent last week.
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.                                 ---- 37 ----
  2018.  
  2019.                       HOW TO GET THE MOST OUT OF RAMS
  2020.                      ===============================
  2021.     Although Rams is fairly easy to setup (it is isn't it?), there are
  2022.     a number of ways you can use it to increase it's flexibility even
  2023.     further. Lets take a look at a couple of ideas to show you what we
  2024.     mean.
  2025.  
  2026.     Rams can manipulate the user security levels, flags, Group etc etc.
  2027.     By using these features to their fullest you can get the best out
  2028.     of Rams. The ideas and suggestions listed below are only a quick
  2029.     guideline to what you can do, and are intended only as an outline.
  2030.     You can use these suggestions in your own setup, or devise your own
  2031.     ideas based on them.
  2032.  
  2033.  
  2034.     USING FLAGS
  2035.     -----------
  2036.     Firstly, lets assume you want Rams to post a message to a user when
  2037.     they use the BlueWave maildoor telling them about becoming a point,
  2038.     but you only want this message to be posted ONCE, and not EVERY time
  2039.     they use the door.
  2040.  
  2041.     This is a fairly easy one, simply setup a 'Keyword' message so that
  2042.     Rams will scan the RA log for something that appears in the log entry
  2043.     that RA writes when it loads the BlueWave door. This may be something
  2044.     like 'C:\RA\BLUEWAVE\BWDOOR.BAT' - Assuming that you call BlueWave
  2045.     with a batch file called BWDoor.Bat. Enter that into the 'Keyword' msg
  2046.     as the text for Rams to scan for...
  2047.  
  2048.     Then go into the message 'Conditions' and set User flag A1 to OFF - that
  2049.     is toggle the entry for flag A1 (using the spacebar) until it changes
  2050.     to an 'O'. That will tell Rams to ONLY post that message IF the user has
  2051.     flag A1 OFF. Jump to the 'Actions' menu and set flag A1 to ON by toggling
  2052.     it as you did before, but this time set if to 'X'. That will tell Rams
  2053.     to alter the user flag A1 to ON when it posts the message to the user.
  2054.     This obviously assumes that you aren't using the A1 flag for anything
  2055.     else... If you are, simply select a different user flag.
  2056.  
  2057.     Then create a message template file that contains the text you want to
  2058.     send to the user if he enters the BlueWave mail door - This is detailed
  2059.     elsewhere in these docs... And enter the name of the message template
  2060.     file into the config for this message.
  2061.  
  2062.     Okay, so what does all that actually mean? Well, Now what you've done
  2063.     is to tell Rams to post a 'Keyword' message when it finds the RA log
  2064.     entry for BlueWave, BUT ONLY if the user has flag A1 OFF... If flag
  2065.     A1 is ON Rams will NOT post the message. When Rams posts the message
  2066.     it will reset the A1 flag to ON, therefore the user will NOT receive
  2067.     that message again as he no longer matches the 'Conditions' for the
  2068.     message. Easy or what? :-)
  2069.  
  2070.  
  2071.  
  2072.  
  2073.                                 ---- 38 ----
  2074.  
  2075.     USING SECURITY LEVELS
  2076.     ---------------------
  2077.  
  2078.     Okay, now lets assume you want to downgrade a user when their sub-
  2079.     scription has expired.
  2080.  
  2081.     Firstly you can warn your users that their subs are about to expire
  2082.     by setting up a message that will be posted 30 days BEFORE their subs
  2083.     are due, and perhaps another 7 days BEFORE. Simply create two 'Subs'
  2084.     messages, one with a value of '30' days and one with a value of '7'
  2085.     days. You can set the message 'Conditions' for minimum AND maximum
  2086.     seclevel to 50 - In other word ONLY users of seclevel 50 will be sent
  2087.     the message(s). These message will be posted 30 days before the users
  2088.     subs expire, and again 7 days before they expire.
  2089.  
  2090.     Lets say that 'Normal' users have an access level of 10 and 'Subscribers'
  2091.     have an access level of 50.
  2092.  
  2093.     Setup a third 'Subscription' message with a value of '0' (zero) days.
  2094.     Then set the message 'Conditions' to 50 for min AND max security, and
  2095.     ALSO setup an 'Action' to 'Change' the users seclevel to a value of
  2096.     10. Rams will then post a message to the user on the day that their
  2097.     subs expire and will alter their access level to 10.
  2098.  
  2099.  
  2100.     FURTHER IDEAS/SUGGESTIONS
  2101.     -------------------------
  2102.     The above are only two possible ways of making Rams more flexible. The
  2103.     potential number of ways you can use it are almost endless. Only YOUR
  2104.     imagination can come up with ALL the possibilities...
  2105.  
  2106.     You could warn users that drop carrier that their behaviour will not
  2107.     be tolerated. And reduce their access if they drop carrier more than 10
  2108.     times say... How do you do that? Simple... Lets assume 'Normal' users
  2109.     have an access level of 20 and twits have an access level of 10...
  2110.     So you have TWO entries in your LIMITS.CTL file for RA.. One for level
  2111.     20 access and another for level 10 access. You will need to add a third
  2112.     entry for level 11... I'll explain why in a minute. This entry needs to
  2113.     be the same as the access for level 20.
  2114.  
  2115.     Then setup a carrier drop message that is posted whenever a user drops
  2116.     carrier. Set it's 'Conditions' to Max seclevel 20, Min seclevel 11. Also
  2117.     set the 'Actions' to DECREASE the users seclevel by 1 to a MINIMUM value
  2118.     of 10... Rams will then post the user a message EVERY time they drop
  2119.     carrier AND it will REDUCE their access level by ONE everytime it posts
  2120.     the message.
  2121.  
  2122.     If a user has an access level of 20, RA will use the normal level 20
  2123.     defined in your LIMITS.CTL file. If they are BELOW level 20 BUT ABOVE
  2124.     level 10, RA will use the entry defined for access level 11 because it
  2125.     will ALWAYS use the level BELOW the users actual seclevel if an entry
  2126.     for that particular level doesn't exist in the LIMITS.CTL file. See your
  2127.     RA doc for more info.
  2128.  
  2129.                                 ---- 39 ----
  2130.  
  2131.  
  2132.  
  2133.  cont...
  2134.     So what happens now is that Rams will DECREASE the users access by ONE
  2135.     each time they drop carrier... RA will use the values stored in the
  2136.     LIMITS.CTL file for seclevel 11 once they have dropped below access
  2137.     level 20... Rams will continue to decrease their access by one each time
  2138.     UNTIL they are eventually reduced to level 10... Then RA ZAPS EM! :-)
  2139.  
  2140.     Rams will not post the message anymore after they reach level 10 as that
  2141.     is outside the 'Conditions' specified for the message....
  2142.  
  2143.     FINAL COMMENT
  2144.     -------------
  2145.     The easiest way to fully undersatnd just what Rams can do for you is to
  2146.     play around with it... Try setting up different messages and changing
  2147.     the various conditions/actions. I'm sure you'll soon see just how
  2148.     flexible it can be. All it takes is a little imagination and a bit of
  2149.     time... Once it's setup it's all automatic. No more haveing to downgrade
  2150.     users manually, or even upgrade them... Rams can do it all.
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.                                 ---- 40 ----
  2186.  
  2187.                       BUG REPORTS, CONTACTING THE AUTHORS
  2188.                       ===================================
  2189.  
  2190.     Should you find any bugs, undocumented features (future enhancements
  2191.     :-) ) or if something doesn't appear to work as it should :-( Please
  2192.     contact one of the authors at the following addresses:
  2193.  
  2194.  
  2195.               To:         Eddy Matthews
  2196.               Netmail:    2:256/651@fidonet
  2197.               Snailmail:  32 Whitley Road
  2198.                           Thornaby
  2199.                           Cleveland
  2200.                           TS17 9HZ
  2201.                           England
  2202.               Voice:      +44-642-766373 (8am to 9pm GMT)
  2203.               Data:       +44-642-764245 (24hrs @28.8k)
  2204.  
  2205.  
  2206.     or alternatively contact:-
  2207.  
  2208.               To:         Geoff Bassett
  2209.               Netmail:    2:259/651@fidonet
  2210.                           73:7446/417@RANet
  2211.               Snailmail:  9 Fraser Avenue
  2212.                           Inverkeithing
  2213.                           Fife
  2214.                           Ky11 1eq
  2215.                           SCOTLAND
  2216.               Voice:      +44-1383-414093 (8am to 9pm GMT)
  2217.               Data:       +44-1383-410704 (24 hours @28.8k)
  2218.  
  2219.  
  2220.  
  2221.     Send your registration to :-  InfoSoft BBS  (2:256/651) - Address is
  2222.     included in the registration document.
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.                                 ---- 41 ----
  2242.  
  2243.  
  2244.                       PLANNED FUTURE DEVELOPMENT OF RAMS
  2245.                       ===================================
  2246.  
  2247.     RAMS v1.10 is the second release of RAMS.  There are already plans to
  2248.     develop RAMS much more for future releases...
  2249.     Some already planned enhancements are:-
  2250.  
  2251.       Download messages for those who use RA's internal file manager.
  2252.  
  2253.       Timelimit exceeded messages.
  2254.  
  2255.       Alterations to some of the messages to GREATLY enhance their
  2256.       flexibility.
  2257.  
  2258.       Plus much, much, more...
  2259.  
  2260.     In order to develop future versions fully we  will require  additional
  2261.     beta testers that use RemoteAccess software and would be  grateful if
  2262.     any  Sysops  that are interested  in  RAMS  would  contact  us at the
  2263.     registration  site  with  details  of  their  software  and  hardware
  2264.     configurations so that these enhancements can be implemented.
  2265.  
  2266.     PLEASE NOTE.  -  Anyone that wishes to become a beta tester for these
  2267.                      future versions has to pay  the  normal registration
  2268.                      fee,    and  link into a private beta test echo area
  2269.                      (RAMS_BETA). They will also be required  to call one
  2270.                      of the authors boards to obtain new beta releases of
  2271.                      RAMS on a weekly basis.
  2272.  
  2273.     With your support and help, RAMS will develop into the BEST automatic
  2274.     message utility there is!!!
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.                                 ---- 43 ----
  2298.  
  2299.                                   CREDITS
  2300.                                   -------
  2301.  
  2302.     On a final note from the authors we would like to thank our Beta team
  2303.     for their dedication, hard work, bug reports, and perseverance and to
  2304.     say  that  without  their support  RAMS would not be half the program
  2305.     that it is.. Our beta team not only tested the program patiently, and
  2306.     believe me some of the beta releases did have one or two faults;-)
  2307.     Also to thank them for their input and suggestions,  many of which you
  2308.     see in the final program....
  2309.  
  2310.     The Beta Team
  2311.     -------------
  2312.  
  2313.     Andrew Davison          (The Hard Rock Studio)
  2314.     Gordon Smith            (Tees for Two)
  2315.                             thanks for the help with the multinode stuff!!
  2316.     Andy & Caf Smith        (Zeons Lair)
  2317.     Steve Nutt              (The Computer Room)
  2318.     Cliff Harrold           (The Coracle)
  2319.     Steve Shooter           (Ultimate)
  2320.     Alan Walker             (Highlander)
  2321.  
  2322.     And a final word of thanks to our wives, both for putting up with the
  2323.     countless hours we locked ourselves away in our  computer rooms,  for
  2324.     keeping the coffee flowing,  and  for putting  up with our moods  when
  2325.     things didn't go right!!
  2326.  
  2327.                -----------=== End of Document ===------------
  2328.